<!DOCTYPE html>
<html lang="en-US">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<title>gen_image3 [HALCON算子参考手册]</title>
<style type="text/css">
      body {
    color: #000000;
    background-color: #ffffff;
    margin: 0;
    font-family: Arial, Helvetica, sans-serif;
}

.body_main {
    margin-left: 35px;
    margin-right: 35px;
}

@media screen and (min-width:992px) {

    .body_main {
        margin-left: 10%;
        margin-right: 10%;
    }

    table.toctable {
        width: 80%
    }
}

@media screen and (min-width:1400px) {

    .body_main {
        margin-left: 15%;
        margin-right: 15%;
    }

    table.toctable {
        width: 70%
    }
}

body>div ul ul {
    margin-left: inherit;
}

a:link {
    color: #0044cc;
}

a:link,
a:visited {
    text-decoration: none;
}

a:link:hover,
a:visited:hover {
    text-decoration: underline;
}

th {
    text-align: left;
}

h1,
h2,
h3,
h4,
h5,
h6 {
    text-rendering: optimizeLegibility;
    color: #666666;
}

code {
    font-family: monospace,monospace;
}

h1 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

h2 a.halconoperator {
    font-family: Arial, Helvetica, sans-serif;
    color: #666666;
}

hr {
    border: 0;
    border-top: solid 1px #f28d26;
}

.pre {
    display: block;
    padding-bottom: 1ex;
    font-family: monospace;
    white-space: pre;
}

pre {
    font-family: monospace, monospace;
    padding: 1ex;
    white-space: pre-wrap;
}

.toc {
    font-size: 80%;
    border-top: 1px dashed #f28d26;
    border-bottom: 1px dashed #f28d26;
    padding-top: 5px;
    padding-bottom: 5px;
}

.inv {
    margin: 0;
    border: 0;
    padding: 0;
}

.banner {
    color: #666666;
    padding-left: 1em;
}

.logo {
    background-color: white;
}

.keyboard {
    font-size: 80%;
    padding-left: 3px;
    padding-right: 3px;
    border-radius: 5px;
    border-width: 1px;
    border-style: solid;
    border-color: #f28d26;
    background-color: #f3f3f3;
}

.warning {
    margin-top: 2ex;
    margin-bottom: 1ex;
    padding: 10px;
    text-align: center;
    border: 1px solid;
    color: #bb0000;
    background-color: #fff7f7
}

.imprint {
    margin-top: 1ex;
    font-size: 80%;
    color: #666666;
}

.imprinthead {
    font-weight: bolder;
    color: #666666;
}

.indexlink {
    text-align: right;
    padding-bottom: 5px;
}

.postscript {
    margin-top: 2ex;
    font-size: 80%;
    color: #666666
}

.evenrow {
    background-color: #e7e7ef;
    vertical-align: top;
}

.oddrow {
    background-color: #f7f7ff;
    vertical-align: top;
}

.headrow {
    background-color: #97979f;
    color: #ffffff;
    vertical-align: top;
}

.logorow {
    vertical-align: top;
}

.error {
    color: red;
}

.var {
    font-style: italic
}

.halconoperator {
    font-family: monospace, monospace;
}

span.operator {
    font-family: monospace, monospace;
}

span.procedure {
    font-family: monospace, monospace;
}

span.operation {
    font-family: monospace, monospace;
}

span.feature {
    font-family: Arial, Helvetica, Homerton, sans-serif;
}

ul {
    padding-left: 1.2em;
}

li.dot {
    list-style-type: square;
    color: #f28d26;
}

.breadcrumb {
    font-size: 80%;
    color: white;
    background-color: #062d64;
    margin-bottom: 20px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 15px;
}

.webbar {
    font-size: 80%;
    background-color: #dddddd;
    margin-top: 0px;
    margin-left: -35px;
    margin-right: -35px;
    margin-bottom: 0px;
    padding-top: 5px;
    padding-left: 35px;
    padding-right: 35px;
    padding-bottom: 5px;
}

.footer {
    display: flex;
    flex-wrap: wrap;
    justify-content: space-between;
    border-top: 1px dashed #f28d26;
    font-size: 80%;
    color: #666666;
    padding-bottom: 8px;
}

.footer .socialmedia a {
    padding-left: 7px;
}

.socialmedia {
    padding-top: 10px;
}

.copyright {
    margin-top: 19px;
}

.breadcrumb a {
    color: #ffffff;
    border-bottom: 1px solid white;
}

.breadcrumb a:link:hover,
.breadcrumb a:visited:hover {
    text-decoration: none;
    border-bottom: none;
}

.heading {
    margin-top: 1ex;
    font-size: 110%;
    font-weight: bold;
    color: #666666;
}

.text {
    color: black;
}

.example {
    font-size: 80%;
    background-color: #f3f3f3;
    border: 1px dashed #666666;
    padding: 10px;
}

.displaymath {
    display: block;
    text-align: center;
    margin-top: 1ex;
    margin-bottom: 1ex;
}

.title {
    float: left;
    padding-top: 3px;
    padding-bottom: 3px;
}

.signnote {
    font-family: Arial, Helvetica, Homerton, sans-serif;
    font-size: 80%;
    color: #666666;
    font-weight: lighter;
    font-style: italic
}

.par {
    margin-bottom: 1.5em;
}

.parhead {
    text-align: right;
}

.parname {
    float: left;
}

.pardesc {
    font-size: 85%;
    margin-top: 0.5em;
    margin-bottom: 0.5em;
    margin-left: 2em;
}

.parcat {
    color: #666;
    font-weight: bold;
}

*[data-if=cpp],
*[data-if=c],
*[data-if=dotnet],
*[data-if=com],
*[data-if=python] {
    display: none;
}

.tabbar {
    text-align: right;
    border-bottom: 1px solid #f28d26;
    margin-bottom: 0.5em;
}

ul.tabs {
    padding-top: 3px;
    padding-bottom: 3px;
    margin-top: 10px;
    margin-bottom: 0;
    font-size: 80%
}

ul.tabs li {
    padding-top: 3px;
    padding-bottom: 3px;
    display: inline;
    overflow: hidden;
    list-style-type: none;
    margin: 0;
    margin-left: 8px;
    border-top: 1px solid #666;
    border-left: 1px solid #666;
    border-right: 1px solid #666;
}

ul.tabs li.active {
    border-left: 1px solid #f28d26;
    border-right: 1px solid #f28d26;
    border-top: 1px solid #f28d26;
    border-bottom: 1px solid #fff;
}

ul.tabs li.inactive {
    background-color: #eee;
}

ul.tabs li a {
    padding-left: 5px;
    padding-right: 5px;
    color: #666;
}

ul.tabs li a:link:hover {
    text-decoration: none;
}

ul.tabs li.inactive a {
    color: #666;
}

ul.tabs li.active a {
    color: black;
}

dl.generic dd {
    margin-bottom: 1em;
}

.pari {
    color: olive;
}

.paro {
    color: maroon;
}

.comment {
    font-size: 80%;
    color: green;
    white-space: nowrap;
}

table.grid {
    border-collapse: collapse;
}

table.grid td {
    padding: 5px;
    border: 1px solid;
}

table.layout {
    border: 0px;
}

table.layout td {
    padding: 5px;
}

table.table {
    border-collapse: collapse;
}

table.table td {
    padding: 5px;
    border-left: 0px;
    border-right: 0px;
}

table.table tr:last-child {
    border-bottom: 1px solid;
}

table.table th {
    padding: 5px;
    border-top: 1px solid;
    border-bottom: 1px solid;
    border-left: 0px;
    border-right: 0px;
}

.details_summary {
    cursor: pointer;
}

table.toctable {
    width: 100%;
}

table.toctable col:first-child {
    width: 20%;
}

table.toctable col:nth-last-child(2) {
    width: 8%;
}

table.altcolored tr:nth-child(even) {
    background-color: #f3f3f3;
}

    </style>
<!--OP_REF_STYLE_END-->
<script>
    <!--
var active_lang='hdevelop';function switchVisibility(obj,active_lang,new_lang)
{var display_style='inline';
for(var i=0;i<obj.length;i++)
{if(obj.item(i).getAttribute('data-if')==new_lang)
{obj.item(i).style.display=display_style;}
if(obj.item(i).getAttribute('data-if')==active_lang)
{obj.item(i).style.display='none';}}
return;}
function toggleLanguage(new_lang,initial)
{if(active_lang!=new_lang)
{var lis=document.getElementsByTagName('li');for(var i=0;i<lis.length;i++)
{if(lis.item(i).id=='syn-'+new_lang)
{lis.item(i).className='active';}
else
{lis.item(i).className='inactive';}}
var divs=document.getElementsByTagName('div');var spans=document.getElementsByTagName('span');switchVisibility(divs,active_lang,new_lang);switchVisibility(spans,active_lang,new_lang);if(!initial)
{setCookie("halcon_reference_language",new_lang,null,null);}
active_lang=new_lang;}
return;}
function setCookie(name,value,domain,exp_offset,path,secure)
{localStorage.setItem(name,value);}
function getCookie(name)
{return localStorage.getItem(name);}
function initialize()
{var qs=location.href.split('?')[1];var qs_lang_raw=location.href.split('interface=')[1];var qs_lang;if(qs_lang_raw)
{qs_lang=qs_lang_raw.split('#')[0];}
var cookie_lang=getCookie("halcon_reference_language");var new_lang;if((qs_lang=="hdevelop")||(qs_lang=="dotnet")||(qs_lang=="python")||(qs_lang=="cpp")||(qs_lang=="c"))
{new_lang=qs_lang;setCookie("halcon_reference_language",new_lang,null,null);}
else if((cookie_lang=="hdevelop")||(cookie_lang=="dotnet")||(cookie_lang=="python")||(cookie_lang=="cpp")||(cookie_lang=="c"))
{new_lang=cookie_lang;}
else
{new_lang="hdevelop";}
toggleLanguage(new_lang,1);return;}
-->

  </script>
</head>
<body onload="initialize();">
<div class="breadcrumb">
<br class="inv"><a href="index.html">目录</a> / <a href="toc_image.html">Image</a> / <a href="toc_image_creation.html">Creation</a><br class="inv">
</div>
<div class="body_main">
<div class="tabbar"><ul class="tabs">
<li id="syn-hdevelop" class="active"><a href="javascript:void(0);" onclick="toggleLanguage('hdevelop')" onfocus="blur()">HDevelop</a></li>
<li id="syn-dotnet" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('dotnet')" onfocus="blur()">.NET</a></li>
<li id="syn-python" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('python')" onfocus="blur()">Python</a></li>
<li id="syn-cpp" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('cpp')" onfocus="blur()">C++</a></li>
<li id="syn-c" class="inactive"><a href="javascript:void(0);" onclick="toggleLanguage('c')" onfocus="blur()">C</a></li>
</ul></div>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<!--OP_REF_HEADER_END-->
<h1 id="sec_name">
<span data-if="hdevelop" style="display:inline;">gen_image3</span><span data-if="c" style="display:none;">gen_image3</span><span data-if="cpp" style="display:none;">GenImage3</span><span data-if="dotnet" style="display:none;">GenImage3</span><span data-if="python" style="display:none;">gen_image3</span> (算子名称)</h1>
<h2>名称</h2>
<p><code><span data-if="hdevelop" style="display:inline;">gen_image3</span><span data-if="c" style="display:none;">gen_image3</span><span data-if="cpp" style="display:none;">GenImage3</span><span data-if="dotnet" style="display:none;">GenImage3</span><span data-if="python" style="display:none;">gen_image3</span></code> — Create an image from three pointers to the pixels (red/green/blue).</p>
<h2 id="sec_synopsis">参数签名</h2>
<div data-if="hdevelop" style="display:inline;">
<p>
<code><b>gen_image3</b>( : <a href="#ImageRGB"><i>ImageRGB</i></a> : <a href="#Type"><i>Type</i></a>, <a href="#Width"><i>Width</i></a>, <a href="#Height"><i>Height</i></a>, <a href="#PixelPointerRed"><i>PixelPointerRed</i></a>, <a href="#PixelPointerGreen"><i>PixelPointerGreen</i></a>, <a href="#PixelPointerBlue"><i>PixelPointerBlue</i></a> : )</code></p>
</div>
<div data-if="c" style="display:none;">
<p>
<code>Herror <b>gen_image3</b>(Hobject* <a href="#ImageRGB"><i>ImageRGB</i></a>, const char* <a href="#Type"><i>Type</i></a>, const Hlong <a href="#Width"><i>Width</i></a>, const Hlong <a href="#Height"><i>Height</i></a>, const Hlong <a href="#PixelPointerRed"><i>PixelPointerRed</i></a>, const Hlong <a href="#PixelPointerGreen"><i>PixelPointerGreen</i></a>, const Hlong <a href="#PixelPointerBlue"><i>PixelPointerBlue</i></a>)</code></p>
<p>
<code>Herror <b>T_gen_image3</b>(Hobject* <a href="#ImageRGB"><i>ImageRGB</i></a>, const Htuple <a href="#Type"><i>Type</i></a>, const Htuple <a href="#Width"><i>Width</i></a>, const Htuple <a href="#Height"><i>Height</i></a>, const Htuple <a href="#PixelPointerRed"><i>PixelPointerRed</i></a>, const Htuple <a href="#PixelPointerGreen"><i>PixelPointerGreen</i></a>, const Htuple <a href="#PixelPointerBlue"><i>PixelPointerBlue</i></a>)</code></p>
</div>
<div data-if="cpp" style="display:none;">
<p>
<code>void <b>GenImage3</b>(HObject* <a href="#ImageRGB"><i>ImageRGB</i></a>, const HTuple&amp; <a href="#Type"><i>Type</i></a>, const HTuple&amp; <a href="#Width"><i>Width</i></a>, const HTuple&amp; <a href="#Height"><i>Height</i></a>, const HTuple&amp; <a href="#PixelPointerRed"><i>PixelPointerRed</i></a>, const HTuple&amp; <a href="#PixelPointerGreen"><i>PixelPointerGreen</i></a>, const HTuple&amp; <a href="#PixelPointerBlue"><i>PixelPointerBlue</i></a>)</code></p>
<p>
<code>void <a href="HImage.html">HImage</a>::<b>GenImage3</b>(const HString&amp; <a href="#Type"><i>Type</i></a>, Hlong <a href="#Width"><i>Width</i></a>, Hlong <a href="#Height"><i>Height</i></a>, void* <a href="#PixelPointerRed"><i>PixelPointerRed</i></a>, void* <a href="#PixelPointerGreen"><i>PixelPointerGreen</i></a>, void* <a href="#PixelPointerBlue"><i>PixelPointerBlue</i></a>)</code></p>
<p>
<code>void <a href="HImage.html">HImage</a>::<b>GenImage3</b>(const char* <a href="#Type"><i>Type</i></a>, Hlong <a href="#Width"><i>Width</i></a>, Hlong <a href="#Height"><i>Height</i></a>, void* <a href="#PixelPointerRed"><i>PixelPointerRed</i></a>, void* <a href="#PixelPointerGreen"><i>PixelPointerGreen</i></a>, void* <a href="#PixelPointerBlue"><i>PixelPointerBlue</i></a>)</code></p>
<p>
<code>void <a href="HImage.html">HImage</a>::<b>GenImage3</b>(const wchar_t* <a href="#Type"><i>Type</i></a>, Hlong <a href="#Width"><i>Width</i></a>, Hlong <a href="#Height"><i>Height</i></a>, void* <a href="#PixelPointerRed"><i>PixelPointerRed</i></a>, void* <a href="#PixelPointerGreen"><i>PixelPointerGreen</i></a>, void* <a href="#PixelPointerBlue"><i>PixelPointerBlue</i></a>)  <span class="signnote">
            (
            Windows only)
          </span></code></p>
</div>
<div data-if="com" style="display:none;"></div>
<div data-if="dotnet" style="display:none;">
<p>
<code>static void <a href="HOperatorSet.html">HOperatorSet</a>.<b>GenImage3</b>(out <a href="HObject.html">HObject</a> <a href="#ImageRGB"><i>imageRGB</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Type"><i>type</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Width"><i>width</i></a>, <a href="HTuple.html">HTuple</a> <a href="#Height"><i>height</i></a>, <a href="HTuple.html">HTuple</a> <a href="#PixelPointerRed"><i>pixelPointerRed</i></a>, <a href="HTuple.html">HTuple</a> <a href="#PixelPointerGreen"><i>pixelPointerGreen</i></a>, <a href="HTuple.html">HTuple</a> <a href="#PixelPointerBlue"><i>pixelPointerBlue</i></a>)</code></p>
<p>
<code>void <a href="HImage.html">HImage</a>.<b>GenImage3</b>(string <a href="#Type"><i>type</i></a>, int <a href="#Width"><i>width</i></a>, int <a href="#Height"><i>height</i></a>, IntPtr <a href="#PixelPointerRed"><i>pixelPointerRed</i></a>, IntPtr <a href="#PixelPointerGreen"><i>pixelPointerGreen</i></a>, IntPtr <a href="#PixelPointerBlue"><i>pixelPointerBlue</i></a>)</code></p>
</div>
<div data-if="python" style="display:none;">
<p>
<code>def <b>gen_image3</b>(<a href="#Type"><i>type</i></a>: str, <a href="#Width"><i>width</i></a>: int, <a href="#Height"><i>height</i></a>: int, <a href="#PixelPointerRed"><i>pixel_pointer_red</i></a>: int, <a href="#PixelPointerGreen"><i>pixel_pointer_green</i></a>: int, <a href="#PixelPointerBlue"><i>pixel_pointer_blue</i></a>: int) -&gt; HObject</code></p>
</div>
<h2 id="sec_description">描述</h2>
<p>该算子 <code><span data-if="hdevelop" style="display:inline">gen_image3</span><span data-if="c" style="display:none">gen_image3</span><span data-if="cpp" style="display:none">GenImage3</span><span data-if="com" style="display:none">GenImage3</span><span data-if="dotnet" style="display:none">GenImage3</span><span data-if="python" style="display:none">gen_image3</span></code> creates a three-channel image of the
size <a href="#Width"><i><code><span data-if="hdevelop" style="display:inline">Width</span><span data-if="c" style="display:none">Width</span><span data-if="cpp" style="display:none">Width</span><span data-if="com" style="display:none">Width</span><span data-if="dotnet" style="display:none">width</span><span data-if="python" style="display:none">width</span></code></i></a> * <a href="#Height"><i><code><span data-if="hdevelop" style="display:inline">Height</span><span data-if="c" style="display:none">Height</span><span data-if="cpp" style="display:none">Height</span><span data-if="com" style="display:none">Height</span><span data-if="dotnet" style="display:none">height</span><span data-if="python" style="display:none">height</span></code></i></a>.
The pixels in <a href="#PixelPointerRed"><i><code><span data-if="hdevelop" style="display:inline">PixelPointerRed</span><span data-if="c" style="display:none">PixelPointerRed</span><span data-if="cpp" style="display:none">PixelPointerRed</span><span data-if="com" style="display:none">PixelPointerRed</span><span data-if="dotnet" style="display:none">pixelPointerRed</span><span data-if="python" style="display:none">pixel_pointer_red</span></code></i></a>, <a href="#PixelPointerGreen"><i><code><span data-if="hdevelop" style="display:inline">PixelPointerGreen</span><span data-if="c" style="display:none">PixelPointerGreen</span><span data-if="cpp" style="display:none">PixelPointerGreen</span><span data-if="com" style="display:none">PixelPointerGreen</span><span data-if="dotnet" style="display:none">pixelPointerGreen</span><span data-if="python" style="display:none">pixel_pointer_green</span></code></i></a> and
<a href="#PixelPointerBlue"><i><code><span data-if="hdevelop" style="display:inline">PixelPointerBlue</span><span data-if="c" style="display:none">PixelPointerBlue</span><span data-if="cpp" style="display:none">PixelPointerBlue</span><span data-if="com" style="display:none">PixelPointerBlue</span><span data-if="dotnet" style="display:none">pixelPointerBlue</span><span data-if="python" style="display:none">pixel_pointer_blue</span></code></i></a> are stored line-sequentially.
The type of the given pixels
(<a href="#PixelPointerRed"><i><code><span data-if="hdevelop" style="display:inline">PixelPointerRed</span><span data-if="c" style="display:none">PixelPointerRed</span><span data-if="cpp" style="display:none">PixelPointerRed</span><span data-if="com" style="display:none">PixelPointerRed</span><span data-if="dotnet" style="display:none">pixelPointerRed</span><span data-if="python" style="display:none">pixel_pointer_red</span></code></i></a> etc.) must correspond to <a href="#Type"><i><code><span data-if="hdevelop" style="display:inline">Type</span><span data-if="c" style="display:none">Type</span><span data-if="cpp" style="display:none">Type</span><span data-if="com" style="display:none">Type</span><span data-if="dotnet" style="display:none">type</span><span data-if="python" style="display:none">type</span></code></i></a>
(see <a href="gen_image_const.html"><code><span data-if="hdevelop" style="display:inline">gen_image_const</span><span data-if="c" style="display:none">gen_image_const</span><span data-if="cpp" style="display:none">GenImageConst</span><span data-if="com" style="display:none">GenImageConst</span><span data-if="dotnet" style="display:none">GenImageConst</span><span data-if="python" style="display:none">gen_image_const</span></code></a> for a more detailed description of the
pixel types).
The storage for the new image is newly created by HALCON.
Thus, it can be released after the call.
Note that how to pass a pointer value depends on the used operator
signature and programming environment. Make sure to pass the
actual memory address where the image data is stored, not the
address of a pointer variable. Care must be taken not to
truncate 64-bit pointers on 64-bit architectures.</p>
<h2 id="sec_attention">注意</h2>
<p><code><span data-if="hdevelop" style="display:inline">gen_image3</span><span data-if="c" style="display:none">gen_image3</span><span data-if="cpp" style="display:none">GenImage3</span><span data-if="com" style="display:none">GenImage3</span><span data-if="dotnet" style="display:none">GenImage3</span><span data-if="python" style="display:none">gen_image3</span></code> does not check whether the pixels in
<a href="#PixelPointerRed"><i><code><span data-if="hdevelop" style="display:inline">PixelPointerRed</span><span data-if="c" style="display:none">PixelPointerRed</span><span data-if="cpp" style="display:none">PixelPointerRed</span><span data-if="com" style="display:none">PixelPointerRed</span><span data-if="dotnet" style="display:none">pixelPointerRed</span><span data-if="python" style="display:none">pixel_pointer_red</span></code></i></a>,<a href="#PixelPointerGreen"><i><code><span data-if="hdevelop" style="display:inline">PixelPointerGreen</span><span data-if="c" style="display:none">PixelPointerGreen</span><span data-if="cpp" style="display:none">PixelPointerGreen</span><span data-if="com" style="display:none">PixelPointerGreen</span><span data-if="dotnet" style="display:none">pixelPointerGreen</span><span data-if="python" style="display:none">pixel_pointer_green</span></code></i></a>, and
<a href="#PixelPointerBlue"><i><code><span data-if="hdevelop" style="display:inline">PixelPointerBlue</span><span data-if="c" style="display:none">PixelPointerBlue</span><span data-if="cpp" style="display:none">PixelPointerBlue</span><span data-if="com" style="display:none">PixelPointerBlue</span><span data-if="dotnet" style="display:none">pixelPointerBlue</span><span data-if="python" style="display:none">pixel_pointer_blue</span></code></i></a> are valid or not.
Thus, it must be ensured by the user that they are valid.
Otherwise, the program may crash!
</p>
<h2 id="sec_execution">运行信息</h2>
<ul>
  <li>多线程类型:可重入(与非独占操作符并行运行)。</li>
<li>多线程作用域:全局(可以从任何线程调用)。</li>
  <li>未经并行化处理。</li>
</ul>
<h2 id="sec_parameters">参数表</h2>
  <div class="par">
<div class="parhead">
<span id="ImageRGB" class="parname"><b><code><span data-if="hdevelop" style="display:inline">ImageRGB</span><span data-if="c" style="display:none">ImageRGB</span><span data-if="cpp" style="display:none">ImageRGB</span><span data-if="com" style="display:none">ImageRGB</span><span data-if="dotnet" style="display:none">imageRGB</span><span data-if="python" style="display:none">image_rgb</span></code></b> (output_object)  </span><span>image <code>→</code> <span data-if="hdevelop" style="display:inline">object</span><span data-if="dotnet" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="python" style="display:none">HObject</span><span data-if="cpp" style="display:none"><a href="HImage.html">HImage</a></span><span data-if="c" style="display:none">Hobject *</span> (byte / direction / cyclic / int1 / int2 / uint2 / int4 / real)</span>
</div>
<p class="pardesc">Created image with new image matrix.</p>
</div>
  <div class="par">
<div class="parhead">
<span id="Type" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Type</span><span data-if="c" style="display:none">Type</span><span data-if="cpp" style="display:none">Type</span><span data-if="com" style="display:none">Type</span><span data-if="dotnet" style="display:none">type</span><span data-if="python" style="display:none">type</span></code></b> (input_control)  </span><span>string <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">str</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (string)</span><span data-if="dotnet" style="display:none"> (<i>string</i>)</span><span data-if="cpp" style="display:none"> (<i>HString</i>)</span><span data-if="c" style="display:none"> (<i>char*</i>)</span></span>
</div>
<p class="pardesc">Pixel type.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>
    <span data-if="hdevelop" style="display:inline">'byte'</span>
    <span data-if="c" style="display:none">"byte"</span>
    <span data-if="cpp" style="display:none">"byte"</span>
    <span data-if="com" style="display:none">"byte"</span>
    <span data-if="dotnet" style="display:none">"byte"</span>
    <span data-if="python" style="display:none">"byte"</span>
</p>
<p class="pardesc"><span class="parcat">List of values:
      </span><span data-if="hdevelop" style="display:inline">'byte'</span><span data-if="c" style="display:none">"byte"</span><span data-if="cpp" style="display:none">"byte"</span><span data-if="com" style="display:none">"byte"</span><span data-if="dotnet" style="display:none">"byte"</span><span data-if="python" style="display:none">"byte"</span>, <span data-if="hdevelop" style="display:inline">'cyclic'</span><span data-if="c" style="display:none">"cyclic"</span><span data-if="cpp" style="display:none">"cyclic"</span><span data-if="com" style="display:none">"cyclic"</span><span data-if="dotnet" style="display:none">"cyclic"</span><span data-if="python" style="display:none">"cyclic"</span>, <span data-if="hdevelop" style="display:inline">'direction'</span><span data-if="c" style="display:none">"direction"</span><span data-if="cpp" style="display:none">"direction"</span><span data-if="com" style="display:none">"direction"</span><span data-if="dotnet" style="display:none">"direction"</span><span data-if="python" style="display:none">"direction"</span>, <span data-if="hdevelop" style="display:inline">'int1'</span><span data-if="c" style="display:none">"int1"</span><span data-if="cpp" style="display:none">"int1"</span><span data-if="com" style="display:none">"int1"</span><span data-if="dotnet" style="display:none">"int1"</span><span data-if="python" style="display:none">"int1"</span>, <span data-if="hdevelop" style="display:inline">'int2'</span><span data-if="c" style="display:none">"int2"</span><span data-if="cpp" style="display:none">"int2"</span><span data-if="com" style="display:none">"int2"</span><span data-if="dotnet" style="display:none">"int2"</span><span data-if="python" style="display:none">"int2"</span>, <span data-if="hdevelop" style="display:inline">'int4'</span><span data-if="c" style="display:none">"int4"</span><span data-if="cpp" style="display:none">"int4"</span><span data-if="com" style="display:none">"int4"</span><span data-if="dotnet" style="display:none">"int4"</span><span data-if="python" style="display:none">"int4"</span>, <span data-if="hdevelop" style="display:inline">'real'</span><span data-if="c" style="display:none">"real"</span><span data-if="cpp" style="display:none">"real"</span><span data-if="com" style="display:none">"real"</span><span data-if="dotnet" style="display:none">"real"</span><span data-if="python" style="display:none">"real"</span>, <span data-if="hdevelop" style="display:inline">'uint2'</span><span data-if="c" style="display:none">"uint2"</span><span data-if="cpp" style="display:none">"uint2"</span><span data-if="com" style="display:none">"uint2"</span><span data-if="dotnet" style="display:none">"uint2"</span><span data-if="python" style="display:none">"uint2"</span></p>
</div>
  <div class="par">
<div class="parhead">
<span id="Width" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Width</span><span data-if="c" style="display:none">Width</span><span data-if="cpp" style="display:none">Width</span><span data-if="com" style="display:none">Width</span><span data-if="dotnet" style="display:none">width</span><span data-if="python" style="display:none">width</span></code></b> (input_control)  </span><span>extent.x <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Width of image.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>512</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span>128, 256, 512, 1024</p>
<p class="pardesc"><span class="parcat">Value range:
      </span><code>1
          ≤
        
    <span data-if="hdevelop" style="display:inline">Width</span>
    <span data-if="c" style="display:none">Width</span>
    <span data-if="cpp" style="display:none">Width</span>
    <span data-if="com" style="display:none">Width</span>
    <span data-if="dotnet" style="display:none">width</span>
    <span data-if="python" style="display:none">width</span>
    </code> (lin)</p>
<p class="pardesc"><span class="parcat">Minimum increment:
      </span>1</p>
<p class="pardesc"><span class="parcat">Recommended increment:
      </span>10</p>
</div>
  <div class="par">
<div class="parhead">
<span id="Height" class="parname"><b><code><span data-if="hdevelop" style="display:inline">Height</span><span data-if="c" style="display:none">Height</span><span data-if="cpp" style="display:none">Height</span><span data-if="com" style="display:none">Height</span><span data-if="dotnet" style="display:none">height</span><span data-if="python" style="display:none">height</span></code></b> (input_control)  </span><span>extent.y <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>int</i> / </span><span data-if="dotnet" style="display:none">long)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Height of image.</p>
<p class="pardesc"><span class="parcat">Default:
      </span>512</p>
<p class="pardesc"><span class="parcat">Suggested values:
      </span>128, 256, 512, 1024</p>
<p class="pardesc"><span class="parcat">Value range:
      </span><code>1
          ≤
        
    <span data-if="hdevelop" style="display:inline">Height</span>
    <span data-if="c" style="display:none">Height</span>
    <span data-if="cpp" style="display:none">Height</span>
    <span data-if="com" style="display:none">Height</span>
    <span data-if="dotnet" style="display:none">height</span>
    <span data-if="python" style="display:none">height</span>
    </code> (lin)</p>
<p class="pardesc"><span class="parcat">Minimum increment:
      </span>1</p>
<p class="pardesc"><span class="parcat">Recommended increment:
      </span>10</p>
</div>
  <div class="par">
<div class="parhead">
<span id="PixelPointerRed" class="parname"><b><code><span data-if="hdevelop" style="display:inline">PixelPointerRed</span><span data-if="c" style="display:none">PixelPointerRed</span><span data-if="cpp" style="display:none">PixelPointerRed</span><span data-if="com" style="display:none">PixelPointerRed</span><span data-if="dotnet" style="display:none">pixelPointerRed</span><span data-if="python" style="display:none">pixel_pointer_red</span></code></b> (input_control)  </span><span>pointer <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>IntPtr</i>)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Pointer to first red value (channel 1).</p>
</div>
  <div class="par">
<div class="parhead">
<span id="PixelPointerGreen" class="parname"><b><code><span data-if="hdevelop" style="display:inline">PixelPointerGreen</span><span data-if="c" style="display:none">PixelPointerGreen</span><span data-if="cpp" style="display:none">PixelPointerGreen</span><span data-if="com" style="display:none">PixelPointerGreen</span><span data-if="dotnet" style="display:none">pixelPointerGreen</span><span data-if="python" style="display:none">pixel_pointer_green</span></code></b> (input_control)  </span><span>pointer <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>IntPtr</i>)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Pointer to first green value (channel 2).</p>
</div>
  <div class="par">
<div class="parhead">
<span id="PixelPointerBlue" class="parname"><b><code><span data-if="hdevelop" style="display:inline">PixelPointerBlue</span><span data-if="c" style="display:none">PixelPointerBlue</span><span data-if="cpp" style="display:none">PixelPointerBlue</span><span data-if="com" style="display:none">PixelPointerBlue</span><span data-if="dotnet" style="display:none">pixelPointerBlue</span><span data-if="python" style="display:none">pixel_pointer_blue</span></code></b> (input_control)  </span><span>pointer <code>→</code> <span data-if="dotnet" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="python" style="display:none">int</span><span data-if="cpp" style="display:none"><a href="HTuple.html">HTuple</a></span><span data-if="c" style="display:none">Htuple</span><span data-if="hdevelop" style="display:inline"> (integer)</span><span data-if="dotnet" style="display:none"> (<i>IntPtr</i>)</span><span data-if="cpp" style="display:none"> (<i>Hlong</i>)</span><span data-if="c" style="display:none"> (<i>Hlong</i>)</span></span>
</div>
<p class="pardesc">Pointer to first blue value (channel 3).</p>
</div>
<h2 id="sec_example_all">例程 (C)</h2>
<pre class="example">
void NewRGBImage(Hobject *new)
{
  unsigned char  red[768*525];
  unsigned char  green[768*525];
  unsigned char  blue[768*525];
  int            r,c;
  for (r=0; r&lt;525; r++)
    for (c=0; c&lt;768; c++)
    {
      red[r*768+c]   = c % 255;
      green[r*768+c] = (767 - c) % 255;
      blue[r*768+c]  = r % 255;
    }
    gen_image3(new,"byte",768,525,(Hlong)red,(long)green,(long)blue);
}

main()
{
  Hobject  rgb;
  open_window(0,0,768,525,0,"","",&amp;WindowHandle);
  NewRGBImage(&amp;rgb);
  disp_color(rgb,WindowHandle);
}</pre>
<h2 id="sec_result">结果</h2>
<p>If the parameter values are correct, 该算子 <code><span data-if="hdevelop" style="display:inline">gen_image3</span><span data-if="c" style="display:none">gen_image3</span><span data-if="cpp" style="display:none">GenImage3</span><span data-if="com" style="display:none">GenImage3</span><span data-if="dotnet" style="display:none">GenImage3</span><span data-if="python" style="display:none">gen_image3</span></code>
返回值 <TT>2</TT> (
      <TT>H_MSG_TRUE</TT>)
    .
Otherwise an exception is raised.</p>
<h2 id="sec_predecessors">可能的前置算子</h2>
<p>
<code><a href="gen_image_const.html"><span data-if="hdevelop" style="display:inline">gen_image_const</span><span data-if="c" style="display:none">gen_image_const</span><span data-if="cpp" style="display:none">GenImageConst</span><span data-if="com" style="display:none">GenImageConst</span><span data-if="dotnet" style="display:none">GenImageConst</span><span data-if="python" style="display:none">gen_image_const</span></a></code>, 
<code><a href="get_image_pointer1.html"><span data-if="hdevelop" style="display:inline">get_image_pointer1</span><span data-if="c" style="display:none">get_image_pointer1</span><span data-if="cpp" style="display:none">GetImagePointer1</span><span data-if="com" style="display:none">GetImagePointer1</span><span data-if="dotnet" style="display:none">GetImagePointer1</span><span data-if="python" style="display:none">get_image_pointer1</span></a></code>
</p>
<h2 id="sec_successors">可能的后置算子</h2>
<p>
<code><a href="disp_color.html"><span data-if="hdevelop" style="display:inline">disp_color</span><span data-if="c" style="display:none">disp_color</span><span data-if="cpp" style="display:none">DispColor</span><span data-if="com" style="display:none">DispColor</span><span data-if="dotnet" style="display:none">DispColor</span><span data-if="python" style="display:none">disp_color</span></a></code>
</p>
<h2 id="sec_alternatives">可替代算子</h2>
<p>
<code><a href="gen_image1.html"><span data-if="hdevelop" style="display:inline">gen_image1</span><span data-if="c" style="display:none">gen_image1</span><span data-if="cpp" style="display:none">GenImage1</span><span data-if="com" style="display:none">GenImage1</span><span data-if="dotnet" style="display:none">GenImage1</span><span data-if="python" style="display:none">gen_image1</span></a></code>, 
<code><a href="compose3.html"><span data-if="hdevelop" style="display:inline">compose3</span><span data-if="c" style="display:none">compose3</span><span data-if="cpp" style="display:none">Compose3</span><span data-if="com" style="display:none">Compose3</span><span data-if="dotnet" style="display:none">Compose3</span><span data-if="python" style="display:none">compose3</span></a></code>, 
<code><a href="gen_image_const.html"><span data-if="hdevelop" style="display:inline">gen_image_const</span><span data-if="c" style="display:none">gen_image_const</span><span data-if="cpp" style="display:none">GenImageConst</span><span data-if="com" style="display:none">GenImageConst</span><span data-if="dotnet" style="display:none">GenImageConst</span><span data-if="python" style="display:none">gen_image_const</span></a></code>
</p>
<h2 id="sec_see">参考其它</h2>
<p>
<code><a href="reduce_domain.html"><span data-if="hdevelop" style="display:inline">reduce_domain</span><span data-if="c" style="display:none">reduce_domain</span><span data-if="cpp" style="display:none">ReduceDomain</span><span data-if="com" style="display:none">ReduceDomain</span><span data-if="dotnet" style="display:none">ReduceDomain</span><span data-if="python" style="display:none">reduce_domain</span></a></code>, 
<code><a href="paint_gray.html"><span data-if="hdevelop" style="display:inline">paint_gray</span><span data-if="c" style="display:none">paint_gray</span><span data-if="cpp" style="display:none">PaintGray</span><span data-if="com" style="display:none">PaintGray</span><span data-if="dotnet" style="display:none">PaintGray</span><span data-if="python" style="display:none">paint_gray</span></a></code>, 
<code><a href="paint_region.html"><span data-if="hdevelop" style="display:inline">paint_region</span><span data-if="c" style="display:none">paint_region</span><span data-if="cpp" style="display:none">PaintRegion</span><span data-if="com" style="display:none">PaintRegion</span><span data-if="dotnet" style="display:none">PaintRegion</span><span data-if="python" style="display:none">paint_region</span></a></code>, 
<code><a href="set_grayval.html"><span data-if="hdevelop" style="display:inline">set_grayval</span><span data-if="c" style="display:none">set_grayval</span><span data-if="cpp" style="display:none">SetGrayval</span><span data-if="com" style="display:none">SetGrayval</span><span data-if="dotnet" style="display:none">SetGrayval</span><span data-if="python" style="display:none">set_grayval</span></a></code>, 
<code><a href="get_image_pointer1.html"><span data-if="hdevelop" style="display:inline">get_image_pointer1</span><span data-if="c" style="display:none">get_image_pointer1</span><span data-if="cpp" style="display:none">GetImagePointer1</span><span data-if="com" style="display:none">GetImagePointer1</span><span data-if="dotnet" style="display:none">GetImagePointer1</span><span data-if="python" style="display:none">get_image_pointer1</span></a></code>, 
<code><a href="decompose3.html"><span data-if="hdevelop" style="display:inline">decompose3</span><span data-if="c" style="display:none">decompose3</span><span data-if="cpp" style="display:none">Decompose3</span><span data-if="com" style="display:none">Decompose3</span><span data-if="dotnet" style="display:none">Decompose3</span><span data-if="python" style="display:none">decompose3</span></a></code>
</p>
<h2 id="sec_module">模块</h2>
<p>
Foundation</p>
<!--OP_REF_FOOTER_START-->
<hr>
<div class="indexlink">
<a href="index_classes.html"><span data-if="dotnet" style="display:none;">类别</span><span data-if="cpp" style="display:none;">类别</span></a><span data-if="dotnet" style="display:none;"> | </span><span data-if="cpp" style="display:none;"> | </span><a href="index_by_name.html">算子列表</a>
</div>
<div class="footer">
<div class="copyright">HALCON算子参考手册 Copyright © 2015-2023 51Halcon</div>
</div>
</div>
</body>
</html>
